home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat4 / lvtab.z / lvtab
Text File  |  1998-10-20  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. llllvvvvttttaaaabbbb((((4444))))                                                              llllvvvvttttaaaabbbb((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      lvtab - information about logical volumes
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      The file /_e_t_c/_l_v_t_a_b describes the logical volumes used by the local
  13.      machine.  There is an entry in this file for every logical volume which
  14.      is used by the system.  This subsystem is no longer supported with the
  15.      current release. The file format description exists in order to
  16.      facilitate conversion to its replacement XLV.
  17.  
  18.      The file consists of entries which have the form:
  19.  
  20.           _v_o_l_u_m_e__d_e_v_i_c_e__n_a_m_e:[_v_o_l_u_m_e__n_a_m_e]:[_o_p_t_i_o_n_s:]_d_e_v_i_c_e__p_a_t_h_n_a_m_e_s
  21.  
  22.      For example:
  23.  
  24.           lv0:logical volume test:stripes=3:devs=/dev/dsk/ips0d1s7, \
  25.           /dev/dsk/ips0d2s7, /dev/dsk/ips0d3s7
  26.  
  27.      Fields are separated by colons, and lines can be continued by the usual
  28.      backslash convention as illustrated above.  A `#' as the first non-white
  29.      character indicates a comment; blank lines can be present in the file and
  30.      are ignored.
  31.  
  32.      The fields in each entry have the following significance:
  33.  
  34.      _v_o_l_u_m_e__d_e_v_i_c_e__n_a_m_e
  35.           This indicates the names of the special files through which the
  36.           system accesses the logical volume.  In the above example, the entry
  37.           _l_v_0 implies that the logical volume is accessed via the device
  38.           special files /dev/dsk/lv0 and /dev/rdsk/lv0.  Note that volume
  39.           device names are expected to be of the form 'lv' followed by one or
  40.           2 digits; this is enforced by the logical volume utilities.
  41.  
  42.      _v_o_l_u_m_e _n_a_m_e
  43.           This is a human-readable identifying name for the logical volume.
  44.           The logical volume labels on the disks constituting a volume also
  45.           carry a copy of the volume name, so utilities are able to check that
  46.           the logical volume on the disks physically present is actually the
  47.           volume expected by /_e_t_c/_l_v_t_a_b.
  48.  
  49.           This field can be null (indicated by a second colon immediately
  50.           following the one terminating the _v_o_l_u_m_e__d_e_v_i_c_e__n_a_m_e field).  This
  51.           is legal but deprecated, since in this case, no identity check of
  52.           the logical volume can be done by the utilities.
  53.  
  54.      _o_p_t_i_o_n_s
  55.           Some numerical options concerning the volume can appear.  These are
  56.           specified in the format "option_name=number:".  There must be no
  57.           space between the option_name, the '=' sign, the numerical value
  58.           given, and the terminating colon.  Note that since the number of
  59.           options is variable, the terminating colon is considered part of the
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. llllvvvvttttaaaabbbb((((4444))))                                                              llllvvvvttttaaaabbbb((((4444))))
  71.  
  72.  
  73.  
  74.           option entry: it is not necessary to indicate omitted options.
  75.  
  76.           Currently recognized options are:
  77.  
  78.                ssssttttrrrriiiippppeeeessss====
  79.                sssstttteeeepppp====
  80.  
  81.           The ssssttttrrrriiiippppeeeessss option allows a striped logical volume to be created;
  82.           the value of the parameter specifies the number of ways the volume
  83.           storage is striped across its constituent devices.  If this option
  84.           is omitted, the logical volume is unstriped.
  85.  
  86.           The sssstttteeeepppp option is meaningful only for striped volumes (and is
  87.           ignored otherwise); it specifies the granularity with which the
  88.           storage is to be round-robin distributed over the constituent
  89.           devices.  If this option is omitted, the default sssstttteeeepppp value is the
  90.           device tracksize; this is generally a good value so the sssstttteeeepppp option
  91.           is not normally needed.  sssstttteeeepppp is in units of 512-byte blocks.
  92.  
  93.      _d_e_v_i_c_e__p_a_t_h_n_a_m_e_s
  94.           Following any numerical options, there must be a list of the block
  95.           special file pathnames of the devices constituting the logical
  96.           volume.  This is introduced by the keyword
  97.  
  98.                ddddeeeevvvvssss====
  99.  
  100.           The pathnames must be comma-separated.
  101.  
  102.           Each pathname should be the name of the special file for a disk
  103.           device partition in the /_d_e_v/_d_s_k directory.  The partition must be
  104.           one which is legal for use as normal data storage--it must not be
  105.           one of the dedicated partitions such as the disk volume label, track
  106.           replacement area, and so on.
  107.  
  108.           If the volume is striped, some restrictions apply:  the number of
  109.           pathnames must be a multiple of ssssttttrrrriiiippppeeeessss.  Further, considering the
  110.           pathnames as successive groups, each of ssssttttrrrriiiippppeeeessss pathnames, the
  111.           devices in each group must be all of the same size.
  112.  
  113.           To obtain best performance from striping, each disk (within every
  114.           group of ssssttttrrrriiiippppeeeessss disks) should be on a separate controller.
  115.  
  116.      The entries from this file are accessed using the program _l_v__t_o__x_l_v(1M),
  117.      which outputs a conversion script to translate between the two formats.
  118.      The file structure is defined in the <_l_v_t_a_b._h> include file.
  119.  
  120. FFFFIIIILLLLEEEESSSS
  121.      /etc/lvtab
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. llllvvvvttttaaaabbbb((((4444))))                                                              llllvvvvttttaaaabbbb((((4444))))
  137.  
  138.  
  139.  
  140. SEE ALSO
  141.      lv_to_xlv(1M),
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.